home *** CD-ROM | disk | FTP | other *** search
/ PCGUIA 114 / PC Guia 114.iso / Software / Produtividade / Apache 2.0.52 / apache_2.0.52-win32-x86-no_ssl.msi / Data.Cab / F278250_mod_cache.xml.ko < prev    next >
Encoding:
Extensible Markup Language  |  2004-04-17  |  12.0 KB  |  324 lines
  1. <?xml version="1.0" encoding="EUC-KR" ?>
  2. <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
  3. <?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?>
  4. <!-- English Revision: 1.12.2.5 -->
  5.  
  6. <!--
  7.  Copyright 2003-2004 The Apache Software Foundation
  8.  
  9.  Licensed under the Apache License, Version 2.0 (the "License");
  10.  you may not use this file except in compliance with the License.
  11.  You may obtain a copy of the License at
  12.  
  13.      http://www.apache.org/licenses/LICENSE-2.0
  14.  
  15.  Unless required by applicable law or agreed to in writing, software
  16.  distributed under the License is distributed on an "AS IS" BASIS,
  17.  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  18.  See the License for the specific language governing permissions and
  19.  limitations under the License.
  20. -->
  21.  
  22. <modulesynopsis metafile="mod_cache.xml.meta">
  23.  
  24. <name>mod_cache</name>
  25. <description>Content cache keyed to URIs.</description>
  26. <status>Experimental</status>
  27. <sourcefile>mod_cache.c</sourcefile>
  28. <identifier>cache_module</identifier>
  29.  
  30. <summary>
  31.     <note type="warning">
  32.       └╠ ╕≡╡Γ└║ ╜╟╟Φ└√└╬ ╗≤┼┬└╠┤┘. ╣«╝¡┤┬ ╛╞┴≈ └█╛≈┴▀└╠┤┘...
  33.     </note>
  34.  
  35.     <p><module>mod_cache</module>┤┬ ░░└║ ──╟╗┼═┐í └╓┤┬ │╗┐δ└╠│¬
  36.     ╟┴╖╧╜├╡╚ │╗┐δ└╗ ─│╜¼╟╥ ╝÷ └╓┤┬ <a
  37.     href="http://www.ietf.org/rfc/rfc2616.txt">RFC 2616</a>
  38.     ╚ú╚» HTTP │╗┐δ─│╜¼╕ª ▒╕╟÷╟╤┤┘. <module>mod_cache</module>╕ª
  39.     ╗τ┐δ╟╧╖┴╕Θ └·└σ░ⁿ╕«╕≡╡Γ(storage management module)└╠ ╟╩┐Σ╟╧┤┘.
  40.     ▒Γ║╗ ╛╞╞──í ╣Φ╞≈║╗┐í┤┬ ╡╬░í┴÷ └·└σ░ⁿ╕«╕≡╡Γ└╠ └╓┤┘:</p>
  41.     <dl>
  42.     <dt><module>mod_disk_cache</module></dt>
  43.     <dd>┤┬ ╡≡╜║┼⌐▒Γ╣▌ └·└σ░ⁿ╕«└┌╕ª ▒╕╟÷╟╤┤┘.</dd>
  44.  
  45.     <dt><module>mod_mem_cache</module></dt>
  46.     <dd>┤┬ ╕▐╕≡╕«▒Γ╣▌ └·└σ░ⁿ╕«└┌╕ª ▒╕╟÷╟╤┤┘.
  47.     <module>mod_mem_cache</module>┤┬ ╞─└╧▒Γ╝·└┌╕ª ─│╜¼╟╧░┼│¬
  48.     ╚ⁿ(heap) ░°░ú┐í ░┤├╝╕ª ─│╜¼╟╧┤┬ ╡╬░í┴÷ ╣µ╜─┴▀ ╟╤░í┴÷ ╣µ╣²└╕╖╬
  49.     ╡┐└█╟╧╡╡╖╧ ╝│┴ñ╟╥ ╝÷ └╓┤┘. <module>mod_mem_cache</module>┤┬
  50.     └┌╜┼└╠ ╗²╝║╟╤ │╗┐δ└╗ ─│╜¼╟╧░┼│¬, (<dfn>┐¬╟┴╖╧╜├(reverse proxy)</dfn>╖╬
  51.     ╛╦╖┴┴°) <directive module="mod_proxy">ProxyPass</directive>╕ª
  52.     ╗τ┐δ╟╧┐⌐ <module>mod_proxy</module>╕ª └º╟╪ ╡▐┤▄ ╝¡╣÷│╗┐δ└╗
  53.     ─│╜¼╟╥ ╝÷ └╓┤┘.</dd>
  54.     </dl>
  55.  
  56.     <p>│╗┐δ└╗ URI╕ª ┼Σ┤δ╖╬ ╕╕╡τ ┼░╖╬ ─│╜¼┐í └·└σ╟╧░φ ░í┴«┐┬┤┘.
  57.     ┴ó▒┘║╕╚ú░í ╡╚ │╗┐δ└║ ─│╜¼╟╧┴÷╛╩┤┬┤┘.</p>
  58. </summary>
  59.  
  60. <section id="related"><title>░ⁿ╖├╡╚ ╕≡╡Γ░· ┴÷╜├╛ε</title>
  61.     <related>
  62.       <modulelist>
  63.         <module>mod_disk_cache</module>
  64.         <module>mod_mem_cache</module>
  65.       </modulelist>
  66.       <directivelist>
  67.         <directive module="mod_disk_cache">CacheRoot</directive>
  68.         <directive module="mod_disk_cache">CacheSize</directive>
  69.         <directive module="mod_disk_cache">CacheGcInterval</directive>
  70.         <directive module="mod_disk_cache">CacheDirLevels</directive>
  71.         <directive module="mod_disk_cache">CacheDirLength</directive>
  72.         <directive module="mod_disk_cache">CacheExpiryCheck</directive>
  73.         <directive module="mod_disk_cache">CacheMinFileSize</directive>
  74.         <directive module="mod_disk_cache">CacheMaxFileSize</directive>
  75.         <directive module="mod_disk_cache">CacheTimeMargin</directive>
  76.         <directive module="mod_disk_cache">CacheGcDaily</directive>
  77.         <directive module="mod_disk_cache">CacheGcUnused</directive>
  78.         <directive module="mod_disk_cache">CacheGcClean</directive>
  79.         <directive module="mod_disk_cache">CacheGcMemUsage</directive>
  80.         <directive module="mod_mem_cache">MCacheSize</directive>
  81.         <directive module="mod_mem_cache">MCacheMaxObjectCount</directive>
  82.         <directive module="mod_mem_cache">MCacheMinObjectSize</directive>
  83.         <directive module="mod_mem_cache">MCacheMaxObjectSize</directive>
  84.         <directive module="mod_mem_cache">MCacheRemovalAlgorithm</directive>
  85.         <directive module="mod_mem_cache">MCacheMaxStreamingBuffer</directive>
  86.       </directivelist>
  87.     </related>
  88. </section>
  89.  
  90. <section id="sampleconf"><title>╝│┴ñ┐╣</title>
  91.     <example><title>Sample httpd.conf</title>
  92.       #<br />
  93.       # ┐╣┴ª ─│╜¼ ╝│┴ñ<br />
  94.       #<br />
  95.       LoadModule cache_module modules/mod_cache.so<br />
  96.       <br />
  97.       <IfModule mod_cache.c><br />
  98.       <indent>
  99.         #LoadModule disk_cache_module modules/mod_disk_cache.so<br />
  100.         <IfModule mod_disk_cache.c><br />
  101.         <indent>
  102.           CacheRoot c:/cacheroot<br />
  103.           CacheSize 256<br />
  104.           CacheEnable disk  /<br />
  105.           CacheDirLevels 5<br />
  106.           CacheDirLength 3<br />
  107.         </indent>
  108.         </IfModule> <br />
  109.         <br />
  110.         LoadModule mem_cache_module modules/mod_mem_cache.so<br />
  111.         <IfModule mod_mem_cache.c><br />
  112.         <indent>
  113.           CacheEnable mem  /<br />
  114.           MCacheSize 4096<br />
  115.           MCacheMaxObjectCount 100<br />
  116.           MCacheMinObjectSize 1<br />
  117.           MCacheMaxObjectSize 2048<br />
  118.         </indent>
  119.         </IfModule><br />
  120.       </indent>
  121.       </IfModule>
  122.     </example>
  123. </section>
  124.  
  125. <directivesynopsis>
  126. <name>CacheEnable</name>
  127. <description>┴÷┴ñ╟╤ └·└σ░ⁿ╕«└┌╕ª ╗τ┐δ╟╧┐⌐ ┴÷┴ñ╟╤ URL└╗ ─│╜¼╟╤┤┘</description>
  128. <syntax>CacheEnable <var>cache_type</var> <var>url-string</var></syntax>
  129. <contextlist><context>server config</context><context>virtual host</context>
  130. </contextlist>
  131.  
  132. <usage>
  133.     <p><directive>CacheEnable</directive> ┴÷╜├╛ε╕ª ╗τ┐δ╟╧╕Θ
  134.     <module>mod_cache</module>░í <var>url-string</var> └╠╟╧
  135.     url╡Θ└╗ ─│╜¼╟╤┤┘. ─│╜¼ └·└σ░ⁿ╕«└┌┤┬ <var>cache_type</var>
  136.     ╛╞▒╘╕╒╞«╖╬ ┴÷┴ñ╟╤┤┘. <var>cache_type</var> <code>mem</code>└║
  137.     <module>mod_mem_cache</module>░í ▒╕╟÷╟╧┤┬ ╕▐╕≡╕«▒Γ╣▌
  138.     └·└σ░ⁿ╕«└┌╕ª ╗τ┐δ╟╤┤┘. <var>cache_type</var> <code>disk</code>┤┬
  139.     <module>mod_disk_cache</module>░í ▒╕╟÷╟╧┤┬ ╡≡╜║┼⌐▒Γ╣▌
  140.     └·└σ░ⁿ╕«└┌╕ª ╗τ┐δ╟╤┤┘. <var>cache_type</var> <code>fd</code>┤┬
  141.     <module>mod_mem_cache</module>░í ▒╕╟÷╟╧┤┬ ╞─└╧▒Γ╝·└┌ ─│╜¼╕ª
  142.     ╗τ┐δ╟╤┤┘.</p>
  143.     <p>(╛╞╖í ┐╣┐═ ░░└╠) URL ░°░ú└╠ ┤┘╕Ñ
  144.     <directive>CacheEnable</directive> ┴÷╜├╛ε┐═ ░π─í╕Θ ╜╟┴ª╖╬
  145.     ╟╤ └·└σ░ⁿ╕«└┌░í ┐Σ├╗└╗ ├│╕«╟╥╢º▒ε┴÷ ╡╬ └·└σ░ⁿ╕«└┌╕ª ╕≡╡╬
  146.     ╜╟╟α╟╤┤┘. ╝│┴ñ╞─└╧┐í╝¡ <directive>CacheEnable</directive>
  147.     ┴÷╜├╛ε└╟ ╝°╝¡┤δ╖╬ └·└σ░ⁿ╕«└┌░í ╜╟╟α╡╚┤┘.</p>
  148.  
  149.     <example>
  150.       CacheEnable  mem   /manual<br />
  151.       CacheEnable  fd    /images<br />
  152.       CacheEnable  disk  /<br />
  153.     </example>
  154. </usage>
  155. </directivesynopsis>
  156.  
  157. <directivesynopsis>
  158. <name>CacheDisable</name>
  159. <description>╞»┴ñ URL└╗ ─│╜¼╟╧┴÷ ╛╩┤┬┤┘</description>
  160. <syntax>CacheDisable <var> url-string</var></syntax>
  161. <contextlist><context>server config</context><context>virtual host</context>
  162. </contextlist>
  163.  
  164. <usage>
  165.     <p><directive>CacheDisable</directive> ┴÷╜├╛ε╕ª ╗τ┐δ╟╧╕Θ
  166.     <module>mod_cache</module>░í <var>url-string</var> └╠╟╧└╟
  167.     url╡Θ└╗ ─│╜¼╟╧┴÷ <em>╛╩┤┬┤┘</em>.</p>
  168.  
  169.     <example><title>┐╣┴ª</title>
  170.       CacheDisable /local_files
  171.     </example>
  172. </usage>
  173.  
  174. </directivesynopsis>
  175. <directivesynopsis>
  176. <name>CacheMaxExpire</name>
  177. <description>╣«╝¡╕ª ─│╜¼╟╧┤┬ ├╩┤▄└º ├╓┤δ╜├░ú</description>
  178. <syntax>CacheMaxExpire <var>seconds</var></syntax>
  179. <default>CacheMaxExpire 86400 (╟╧╖τ)</default>
  180. <contextlist><context>server config</context><context>virtual host</context>
  181. </contextlist>
  182.  
  183. <usage>
  184.     <p><directive>CacheMaxExpire</directive> ┴÷╜├╛ε┤┬ ╜╟┴ª ╝¡╣÷╕ª
  185.     ░╦╗τ╟╧┴÷╛╩░φ ─│╜¼░í┤╔╟╤ HTTP ╣«╝¡╕ª └»┴÷╟╥ ╝÷ └╓┤┬ ├╩┤▄└º
  186.     ├╓┤δ╜├░ú└╗ ┴÷┴ñ╟╤┤┘. ┴∩, ╣«╝¡┤┬ ├╓┤δ╟╤ └╠ ╝│┴ñ░¬╕╕┼¡ ┐└╖í╡╟╛·┤┘.
  187.     ╣«╝¡░í ╕╕▒Γ╜├░ú└╗ ┴÷┴ñ╟╧┐⌐╡╡ └╠ ├╓┤δ░¬└╗ ┴÷┼▓┤┘.</p>
  188.  
  189.     <example>
  190.       CacheMaxExpire 604800
  191.     </example>
  192. </usage>
  193. </directivesynopsis>
  194.  
  195. <directivesynopsis>
  196. <name>CacheDefaultExpire</name>
  197. <description>╕╕▒Γ╜├░ú└╗ ┴÷┴ñ╟╧┴÷╛╩└║ ╣«╝¡╕ª ─│╜¼╟╥ ▒Γ║╗ ▒Γ░ú.</description>
  198. <syntax>CacheDefaultExpire <var>seconds</var></syntax>
  199. <default>CacheDefaultExpire 3600 (one hour)</default>
  200. <contextlist><context>server config</context><context>virtual host</context>
  201. </contextlist>
  202.  
  203. <usage>
  204.     <p><directive>CacheDefaultExpire</directive> ┴÷╜├╛ε┤┬ ╣«╝¡└╟
  205.     ╕╕▒Γ╜├░ú░· ├╓▒┘╝÷┴ñ╜├░ú└╠ ╛°┤┬ ░µ┐∞ ╣«╝¡╕ª ─│╜¼╟╥ ├╩┤▄└º
  206.     ▒Γ║╗ ╜├░ú└╗ ┴÷┴ñ╟╤┤┘. <directive>CacheMaxExpire</directive>╖╬
  207.     ┴÷┴ñ╟╤ ░¬└╠ └╠ ╝│┴ñ└╗ ╣½╜├╟╧┴÷ <em>╛╩┤┬┤┘</em>.</p>
  208.  
  209.     <example>
  210.       CacheDefaultExpire 86400
  211.     </example>
  212. </usage>
  213. </directivesynopsis>
  214.  
  215. <directivesynopsis>
  216. <name>CacheIgnoreNoLastMod</name>
  217. <description>└└┤Σ┐í Last Modified ╟∞┤⌡░í ╛°┤┘┤┬ ╗τ╜╟└╗ ╣½╜├╟╤┤┘.</description>
  218. <syntax>CacheIgnoreNoLastMod On|Off</syntax>
  219. <default>CacheIgnoreNoLastMod Off</default>
  220. <contextlist><context>server config</context><context>virtual host</context>
  221. </contextlist>
  222.  
  223. <usage>
  224.     <p>║╕┼δ ├╓▒┘╝÷┴ñ└╧└╠ ╛°┤┬ ╣«╝¡┤┬ ─│╜¼╟╧┴÷ ╛╩┤┬┤┘. ╛ε╢▓ ░µ┐∞
  225.     ├╓▒┘╝÷┴ñ└╧└╗ (┐╣╕ª ╡Θ╛ε <module>mod_include</module> ├│╕«┴▀┐í)
  226.     ╗⌐░┼│¬ ├│└╜║╬┼═ ╛°╛·└╗ ╝÷░í └╓┤┘.
  227.     <directive>CacheIgnoreNoLastMod</directive> ┴÷╜├╛ε┤┬ ├╓▒┘╝÷┴ñ└╧└╠
  228.     ╛°┤┬ ╣«╝¡╡╡ ╣▌╡σ╜├ ─│╜¼╟╧╡╡╖╧ ╕╕╡τ┤┘. ╣«╝¡┐í ├╓▒┘╝÷┴ñ└╧░·
  229.     ╕╕▒Γ╜├░ú└╠ ╛°┤┬ ░µ┐∞ <directive>CacheDefaultExpire</directive>
  230.     ┴÷╜├╛ε╖╬ ┴÷┴ñ╟╤ ░¬└╗ ╕╕▒Γ╜├░ú└╕╖╬ ╗τ┐δ╟╤┤┘.</p>
  231.  
  232.     <example>
  233.       CacheIgnoreNoLastMod On
  234.     </example>
  235. </usage>
  236. </directivesynopsis>
  237.  
  238. <directivesynopsis>
  239. <name>CacheIgnoreCacheControl</name>
  240. <description>┼¼╢≤└╠╛≡╞«░í ─│╜¼╟╧┴÷╛╩┤┬ │╗┐δ└╗ ┐Σ├╗╟╘└╗ ╣½╜├╟╤┤┘.</description>
  241. <syntax>CacheIgnoreCacheControl On|Off</syntax>
  242. <default>CacheIgnoreCacheControl Off</default>
  243. <contextlist><context>server config</context><context>virtual host</context>
  244. </contextlist>
  245.  
  246. <usage>
  247.     <p>║╕┼δ no-cache│¬ no-store ╟∞┤⌡░¬└╗ ░í┴° ╣«╝¡┤┬ ─│╜¼┐í
  248.     └·└σ╟╧┴÷╛╩┤┬┤┘. <directive>CacheIgnoreCacheControl</directive>
  249.     ┴÷╜├╛ε┤┬ └╠╖▒ ╟α╡┐└╗ ║»░µ╟╤┤┘.
  250.     <directive>CacheIgnoreCacheControl</directive> On└╗ ╗τ┐δ╟╧╕Θ
  251.     ╝¡╣÷┤┬ ╣«╝¡┐í no-cache│¬ no-store ╟∞┤⌡░¬└╠ └╓╛ε╡╡ ╣«╝¡╕ª
  252.     ─│╜¼╟╤┤┘. └╬┴⌡└╠ ╟╩┐Σ╟╤ ╣«╝¡┤┬ <em>└²┤δ╖╬</em> ─│╜¼╟╧┴÷
  253.     ╛╩┤┬┤┘.</p>
  254.  
  255.     <example>
  256.       CacheIgnoreCacheControl On
  257.     </example>
  258. </usage>
  259. </directivesynopsis>
  260.  
  261. <directivesynopsis>
  262. <name>CacheLastModifiedFactor</name>
  263. <description>LastModified ╜├░ú└╕╖╬ ╕╕▒Γ╜├░ú└╗ ░Φ╗Ω╟╧┤┬╡Ñ ╗τ┐δ╟╧┤┬
  264. ░Φ╝÷.</description>
  265. <syntax>CacheLastModifiedFactor <var>float</var></syntax>
  266. <default>CacheLastModifiedFactor 0.1</default>
  267. <contextlist><context>server config</context><context>virtual host</context>
  268. </contextlist>
  269.  
  270. <usage>
  271.     <p>╣«╝¡┐í ╕╕▒Γ╜├░ú└║ ╛°┴÷╕╕ ├╓▒┘╝÷┴ñ└╧└╠ └╓┤┬ ░µ┐∞ ├╓▒┘╝÷┴ñ└╧
  272.     └╠╚─ ┴÷│¡ ╜├░ú└╕╖╬ ╕╕▒Γ╜├░ú└╗ ░Φ╗Ω╟╤┤┘.
  273.     <directive>CacheLastModifiedFactor</directive> ┴÷╜├╛ε┤┬
  274.     ╕╕▒Γ╜├░ú└╗ ░Φ╗Ω╟╧┤┬ ┤┘└╜ ░°╜─┐í╝¡ ╗τ┐δ╟╥ <var>factor</var>╕ª
  275.     ┴÷┴ñ╟╤┤┘:
  276.  
  277.     <code>expiry-period = time-since-last-modified-date * <var>factor</var>
  278.     expiry-date = current-date + expiry-period</code>
  279.  
  280.     ┐╣╕ª ╡Θ╛ε, ╣«╝¡░í 10 ╜├░ú └ⁿ┐í ╕╢┴÷╕╖└╕╖╬ ╝÷┴ñ╡╟╛·░φ <var>factor</var>░í
  281.     0.1└╠╢≤╕Θ ╕╕▒Γ▒Γ░ú└║ 10*01 = 1 ╜├░ú└╠ ╡╚┤┘. ╟÷└τ ╜├░ú└╠
  282.     3:00pm└╠╢≤╕Θ ╕╕▒Γ╜├░ú└║ 3:00pm + 1╜├░ú = 4:00pm└╠┤┘.
  283.  
  284.     ╕╕▒Γ▒Γ░ú└╠ <directive>CacheMaxExpire</directive> ║╕┤┘ ▒µ┤┘╕Θ
  285.     <directive>CacheMaxExpire</directive>╕ª ╗τ┐δ╟╤┤┘.</p>
  286.  
  287.     <example>
  288.       CacheLastModifiedFactor 0.5
  289.     </example>
  290. </usage>
  291. </directivesynopsis>
  292.  
  293. <directivesynopsis>
  294. <name>CacheForceCompletion</name>
  295. <description>┐Σ├╗└╠ ├δ╝╥╡╟┤⌡╢≤╡╡ ╝¡╣÷░í ╞─└╧└╗ ░Φ╝╙ ─│╜¼╟╧▒Γ└º╟╪
  296. ╟╩┐Σ╟╤ ╣«╝¡└╟ ╝¡║±╜║╖ⁿ.</description>
  297. <syntax>CacheForceCompletion <var>Percentage</var></syntax>
  298. <default>CacheForceCompletion 60</default>
  299. <contextlist><context>server config</context><context>virtual host</context>
  300. </contextlist>
  301.  
  302. <usage>
  303.     <p>║╕┼δ └└┤Σ└╗ ─│╜¼╟╧░φ ┼¼╢≤└╠╛≡╞«╖╬ ║╕│╗┤┬ ╡╡┴▀┐í ┐Σ├╗└╠
  304.     ├δ╝╥╡╟╕Θ └└┤Σ ├│╕«╕ª ┴▀┤▄╡╟░φ ─│╜¼ ╟╫╕±└╗ ┴÷┐ε┤┘.
  305.     <directive>CacheForceCompletion</directive> ┴÷╜├╛ε┤┬ ┐Σ├╗└╠
  306.     ├δ╝╥╡╟┤⌡╢≤╡╡ ╣«╝¡╕ª ░Φ╝╙ ─│╜¼╟╥ ┴ñ╡╡╕ª ┴÷┴ñ╟╤┤┘.</p>
  307.  
  308.     <p>┴ñ╡╡┤┬ ╣Θ║╨└▓╖╬ │¬┼╕│╗╕τ <code>1</code>░· <code>100</code>
  309.     ╗τ└╠└╟ ░¬└╠┤┘. <code>0</code> ░¬└╗ ┴÷┴ñ╟╧╕Θ ▒Γ║╗░¬└╗ ╗τ┐δ╟╤┤┘.
  310.     <code>100</code>└║ │╗┐δ└╗ ╕≡╡╬ ╝¡║±╜║╟╤ ╣«╝¡╕╕└╗ ─│╜¼╟╤┤┘.
  311.     60░· 90 ╗τ└╠└╟ ░¬└╗ ├▀├╡╟╤┤┘.</p>
  312.  
  313.     <example>
  314.       CacheForceCompletion 80
  315.     </example>
  316.  
  317.     <note type="warning"><title>┴╓└╟:</title>
  318.       └╠ ▒Γ┤╔└║ ╟÷└τ ▒╕╟÷╡╟┴÷ <em>╛╩╛╥┤┘</em>.
  319.     </note>
  320. </usage>
  321. </directivesynopsis>
  322.  
  323. </modulesynopsis>
  324.